home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / ann32.zip / ANNOUNCE.DOC < prev    next >
Text File  |  1992-05-14  |  9KB  |  220 lines
  1.  
  2.  
  3.                           The Annoncement Door!
  4.                               Version 3.20
  5.  
  6.                          (C)1991,92 T&J Software
  7.  
  8.                                 05/14/92
  9.  
  10.         One of the T&J Software Collection of multi-BBS door programs.
  11.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  12.               UltraBBS, Telegard, TriTel, Remote Access, and WWIV
  13.  
  14.                                   by
  15.  
  16.                               T&J Software
  17.                                 T&J BBS
  18.                              (717)325-9481
  19.                                  24H/7D
  20.                               USR HST 14.4
  21.  
  22.                            397 West Broadway
  23.                           Jim Thorpe, PA 18229
  24.                           (717)325-9480 VOICE
  25.                      5:30 to 10:00 p.m. Eastern Time
  26.  
  27.  
  28. LATEST VERSION:
  29. Please call the T&J BBS for the latest version of this program.
  30.  
  31. LEGALITIES:
  32. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  33. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  34. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  35. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  36. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  37. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  38.  
  39. DISTRIBUTION:
  40. You may make this file available for downloading from your BBS or you may
  41. upload it to any BBS of your choice, provided that you do not make any
  42. changes to the contents of the archive (ZIP file). The archive and its
  43. individual contents may not be used by any service that charges any money
  44. whatsoever, without the written permission of the author.
  45.  
  46. PROGRAM DESCRIPTION:
  47. My users contribute to registering door programs. I made this simple
  48. door as a way for all users to see who payed to have each door
  49. registered. There is no fee for this door.
  50.  
  51. You can also use it as a COMMENT FROM THE SYSOP about the door that
  52. the person is entering.
  53.  
  54. To try the door locally simply run the LOCAL.BAT file.
  55.  
  56. FEATURES:
  57.            --- Return to BBS on dropped carrier.
  58.            --- 4-minutes no activity will return to BBS.
  59.            --- Online Chat.
  60.            --- You can blank the display.
  61.            --- Dump user back to BBS.
  62.            --- Drop to DOS function.
  63.            --- Desqview Aware.
  64.            --- COM1-4 support and non-standard IRQ's.
  65.            --- Colorful ANSI screens.
  66.            --- NO BRUN module needed for play.
  67.            --- BETA tested on five different boards.
  68.            --- Support BBS available.
  69.  
  70. NOTE: When making your ANNOUNCE.SCR screen using your drawing package,
  71.       try leaving the top three lines and bottom three lines blank. Also,
  72.       when saving your screen be sure not to include a clear screen command.
  73.       Save the screen with a "home cursor". If you are using TheDraw greater
  74.       than version 3.3 use a "block save" to save your screen.
  75.  
  76. CONFIGURATION: (ANNOUNCE.CFG)
  77. =============
  78.  
  79. Example configuration file for PCBOARD.SYS
  80. ------------------------------------------
  81.  
  82. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  83. T&J Software        <=-  (Change this to your BBS name)
  84. Tom                 <=-  (The Sysop's first name)
  85. Wildoner            <=-  (The Sysop's last name)
  86.  
  87. Example configuration file for USERS.SYS
  88. ----------------------------------------
  89.  
  90. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  91. T&J Software        <=-  (Change this to your BBS name)
  92. Tom                 <=-  (The Sysop's first name)
  93. Wildoner            <=-  (The Sysop's last name)
  94.  
  95. Example configuration file for DOOR.SYS
  96. ---------------------------------------
  97.  
  98. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  99. T&J Software        <=-  (Change this to your BBS name)
  100. Tom                 <=-  (The Sysop's first name)
  101. Wildoner            <=-  (The Sysop's last name)
  102.  
  103. Example configuration file for USERINFO.DAT
  104. -------------------------------------------
  105.  
  106. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  111.  
  112. Example configuration file for CALLINFO.BBS
  113. -------------------------------------------
  114.  
  115. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  116. T&J Software        <=-  (Change this to your BBS name)
  117. Tom                 <=-  (The Sysop's first name)
  118. Wildoner            <=-  (The Sysop's last name)
  119.  
  120. Example configuration file for DORINFOx.DEF
  121. -------------------------------------------
  122.  
  123. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  124.                           where 'x' is the BBS Node number.
  125. T&J Software        <=-  (Change this to your BBS name)
  126. Tom                 <=-  (The Sysop's first name)
  127. Wildoner            <=-  (The Sysop's last name)
  128.  
  129. Example configuration file for SFDOORS.DAT
  130. ------------------------------------------
  131.  
  132. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  133. T&J Software        <=-  (Change this to your BBS name)
  134. Tom                 <=-  (The Sysop's first name)
  135. Wildoner            <=-  (The Sysop's last name)
  136.  
  137. Example configuration file for CHAIN.TXT
  138. ----------------------------------------
  139.  
  140. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  141. T&J Software        <=-  (Change this to your BBS name)
  142. Tom                 <=-  (The Sysop's first name)
  143. Wildoner            <=-  (The Sysop's last name)
  144.  
  145. Example configuration file for GTUSER.BBS
  146. -----------------------------------------
  147.  
  148. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  149. T&J Software        <=-  (Change this to your BBS name)
  150. Tom                 <=-  (The Sysop's first name)
  151. Wildoner            <=-  (The Sysop's last name)
  152. 1                   <=-  (COM port number - defaults to 1)
  153. 1                   <=-  (Node number - defaults to 1)
  154.  
  155. Example Batch File
  156. ==================
  157.  
  158. A sample batch file is included and is similer to the following:
  159.    ECHO OFF
  160.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  161.    ANN32 ANNOUNCE.CFG       <=- Execute Announce!
  162.    LEMON30 LEMON.CFG        <=- Execute the door program and pass the
  163.                                 configuration filename to the program.
  164.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  165.    BOARD                    <=- Restart BBS.
  166.  
  167. This Door is multi-node  compatible so you may run more than 1 node from
  168. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  169. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  170. variables, (q.v.)
  171.  
  172. Environment Variables
  173. =====================
  174.  
  175. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  176. variables. Non-PCBoard systems may also use these variables by including
  177. the following in either your BBS batch or AUTOEXEC.BAT
  178.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  179.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  180. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  181. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  182. .CFG file for multi-node operation!
  183.  
  184. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  185. command line.  For example:
  186.  
  187.      LEMON30 LEMON.CFG /5
  188. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  189.      LEMON30 LEMON.CFG /%IRQ%
  190.  
  191. This tells the program to use IRQ 5 instead of the standard IRQ.
  192.  
  193.  
  194. Sysop Keys
  195. ==========
  196.  
  197. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  198.          written to DOOR.SYS and USERS.SYS
  199. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  200.          and/or written to DOOR.SYS and USERS.SYS
  201. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  202. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  203.          and/or written to DOOR.SYS and USERS.SYS
  204. F8    -  Returns the caller involuntarily to the BBS.
  205. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  206.          and/or written to DOOR.SYS and USERS.SYS
  207. F10   -  Activates SysOp CHAT mode within the DOOR.
  208. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  209. UP    -  Give the caller extra time while in the DOOR.  
  210. DN    -  Subtract time from the caller while in the DOOR. 
  211. HOME  -  HELP key for Status Line options.
  212. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  213. ALT-X -  PCBoard will exit after current caller logs off. Value is
  214.          passed to PCBoard. Not available on non-PCBoard systems.
  215.  
  216. If you have any problems/suggestions please feel free to contact The
  217. T&J BBS.
  218.  
  219. See the REGISTER.TXT file for other programs from T&J Software!
  220.